home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / SV_ALLOC.z / SV_ALLOC
Encoding:
Text File  |  2002-10-03  |  7.0 KB  |  132 lines
  1.  
  2.  
  3.  
  4. SSSSVVVV____AAAALLLLLLLLOOOOCCCC((((DDDD3333))))                                                      SSSSVVVV____AAAALLLLLLLLOOOOCCCC((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC, _SSSS_VVVV______IIII_NNNN_IIII_TTTT - synchronization variable initialization
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_kkkk_mmmm_eeee_mmmm_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_kkkk_ssss_yyyy_nnnn_cccc_hhhh_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  16.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_eeee_mmmm_aaaa_...._hhhh_>>>>
  17.      _ssss_vvvv______tttt _****_SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC_((((_iiii_nnnn_tttt _tttt_yyyy_pppp_eeee_,,,, _iiii_nnnn_tttt _ffff_llll_aaaa_gggg_,,,, _cccc_hhhh_aaaa_rrrr _****_nnnn_aaaa_mmmm_eeee_))))_;;;;
  18.  
  19.      _vvvv_oooo_iiii_dddd _SSSS_VVVV______IIII_NNNN_IIII_TTTT_((((_ssss_vvvv______tttt _****_ssss_vvvv_pppp_,,,, _iiii_nnnn_tttt _tttt_yyyy_pppp_eeee_,,,, _cccc_hhhh_aaaa_rrrr _****_nnnn_aaaa_mmmm_eeee_))))_;;;;
  20.  
  21.    AAAArrrrgggguuuummmmeeeennnnttttssss
  22.      _s_v_p       Pointer to uninitialized synchronization variable.
  23.  
  24.      _t_y_p_e      Specifies the order in which threads of execution that are
  25.                waiting on the synchronization variable are dequeued when
  26.                _SSSS_VVVV______SSSS_IIII_GGGG_NNNN_AAAA_LLLL or _SSSS_VVVV______BBBB_RRRR_OOOO_AAAA_DDDD_CCCC_AAAA_SSSS_TTTT are called.
  27.  
  28.      _f_l_a_g      Specifies whether the caller is willing to sleep waiting for
  29.                memory.
  30.  
  31.      _n_a_m_e      Ascii string associated with the synchronization object.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      _SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC dynamically allocates and initializes an instance of a
  35.      synchronization variable.  _SSSS_VVVV______IIII_NNNN_IIII_TTTT initializes an instance of a
  36.      synchronization variable.
  37.  
  38.      If _t_y_p_e is set to either _SSSS_VVVV______DDDD_EEEE_FFFF_AAAA_UUUU_LLLL_TTTT or _SSSS_VVVV______FFFF_IIII_FFFF_OOOO, waiting threads of
  39.      execution are wakened in first-in, first-out order; if the type is
  40.      _SSSS_VVVV______LLLL_IIII_FFFF_OOOO, they are dequeued in first-in, last-out order.  If the
  41.      synchronization variable is of type _SSSS_VVVV______PPPP_RRRR_IIII_OOOO, waiters will be processed in
  42.      priority order.
  43.  
  44.      If _f_l_a_g is set to _KKKK_MMMM______SSSS_LLLL_EEEE_EEEE_PPPP, the caller of _SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC will sleep if
  45.      necessary until sufficient memory is available.  If _f_l_a_g is set to
  46.      _KKKK_MMMM______NNNN_OOOO_SSSS_LLLL_EEEE_EEEE_PPPP, the caller will not sleep, but _SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC will return _NNNN_UUUU_LLLL_LLLL if
  47.      sufficient memory is not immediately available.
  48.  
  49.      The _n_a_m_e argument is only used if the metering sleep-locks package is
  50.      installed.  A null _n_a_m_e is ignored.
  51.  
  52.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  53.      Upon successful completion, _SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC returns a pointer to the newly
  54.      allocated lock.  If _KKKK_MMMM______NNNN_OOOO_SSSS_LLLL_EEEE_EEEE_PPPP is specified and sufficient memory is not
  55.      immediately available, _SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC returns a _NNNN_UUUU_LLLL_LLLL pointer.
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. SSSSVVVV____AAAALLLLLLLLOOOOCCCC((((DDDD3333))))                                                      SSSSVVVV____AAAALLLLLLLLOOOOCCCC((((DDDD3333))))
  70.  
  71.  
  72.  
  73. UUUUSSSSAAAAGGGGEEEE
  74.    LLLLeeeevvvveeeellll
  75.      Base or Initialization.
  76.  
  77.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  78.      _SSSS_VVVV______AAAA_LLLL_LLLL_OOOO_CCCC may sleep if flag is set to _KKKK_MMMM______SSSS_LLLL_EEEE_EEEE_PPPP.
  79.  
  80.      Driver-defined basic locks and read/write locks may be held across calls
  81.      to this function if _f_l_a_g is _KKKK_MMMM______NNNN_OOOO_SSSS_LLLL_EEEE_EEEE_PPPP but may not be held if _f_l_a_g is
  82.      _KKKK_MMMM______SSSS_LLLL_EEEE_EEEE_PPPP.
  83.  
  84.      Driver-defined sleep locks may be held across calls to this function
  85.      regardless of the value of _f_l_a_g.
  86.  
  87. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  88.      _SSSS_VVVV______DDDD_EEEE_AAAA_LLLL_LLLL_OOOO_CCCC(D3), _SSSS_VVVV______DDDD_EEEE_SSSS_TTTT_RRRR_OOOO_YYYY(D3), _SSSS_VVVV______WWWW_AAAA_IIII_TTTT(D3), _SSSS_VVVV______WWWW_AAAA_IIII_TTTT______SSSS_IIII_GGGG(D3),
  89.      _SSSS_VVVV______SSSS_IIII_GGGG_NNNN_AAAA_LLLL(D3), _SSSS_VVVV______BBBB_RRRR_OOOO_AAAA_DDDD_CCCC_AAAA_SSSS_TTTT(D3).
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.